home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / uucp / uucpst11 / uucp_doc.txt < prev    next >
Text File  |  1996-07-10  |  7KB  |  161 lines
  1. UUCP-ST Documentation
  2. Version 1.01, 10 July 1996
  3. ==========================
  4.  
  5. Copyright
  6. =========
  7. This entire package, hereinafter referred to as "UUCP-ST" and/or 
  8. "UUCP" is copyright 1996 by Rich Tietjens and FTI Consulting.  Limited 
  9. rights are granted to use the software without modification.  The 
  10. programs are released without warranty of any kind, including fitness 
  11. for a particular purpose.  The package should contain the following:
  12.  
  13.   AGE_HIST.PRG    Controls the size of the message history file
  14.   EMAILOUT.PRG    Exports Fido netmail to Internet email
  15.   EMAIL_IN.PRG    Imports Fido netmail from Internet email
  16.   NEWS_IN.PRG     Imports Fido echomail from Usenet newsgroups
  17.   NEWS_OUT.PRG    Exports Fido echomail to Usenet newsgroups
  18.   PURGE.PRG       (Unsupported) Kills selected messages
  19.   STATS.PRG       Reports userbase statistics
  20.   UNLOCK.PRG      Deletes "orphan" files in the NOS tree
  21.   EXAMPLE.CTL     Commented example control file for UUCP-ST
  22.   WORMHOLE.CTL    Commented example control file for Wormhole
  23.   WORMHOLE.PRG    Imports and exports Fido packets via Internet email
  24.   HELP.TXT        Sent to new users & users who send a "help" message
  25.   HISTORY.TXT     Development history of UUCP-ST
  26.   INSTALL.TXT     Quick Start installation instructions
  27.   TO-DO.TXT       To-do list (and known bug list)
  28.   UUCP_DOC.TXT    This document
  29.   WARNING.TXT     Warning text sent to users trying to access
  30.                     Archie/Ftpmail servers
  31.  
  32. Terms of Use
  33. ============
  34. You are permitted to use the software without registration for a 
  35. period of 90 consecutive days from the date of first installation.  No 
  36. restrictions are placed on function or use of unregistered versions; 
  37. however, no support will be offered to unregistered users beyond bug 
  38. fixes which would be released in the normal course of events.
  39.  
  40. The Wormhole program is provided as freeware.  Sysops are requested to
  41. send email to me at one of the provided addresses (see below), or a
  42. nice picture postcard via snail mail, to register, but no functions are
  43. disabled in the unregistered release.  Registered Wormhole sysops will
  44. receive priority for requested features, and a warm fuzzy feeling inside.
  45.  
  46. Priveleges of Registered Users
  47. ==============================
  48. UUCP-ST is a shareware package which will be undergoing continuous 
  49. development and upgrade.  Users of the package who register will be 
  50. given special consideration for adding desired features, direct email 
  51. contact, and special ftp access which will not be available to 
  52. unregistered users.
  53.  
  54. How To Register
  55. ===============
  56. Send email to starship@3rdplanet.com (Rich Tietjens), or netmail to 
  57. Rich Tietjens on 51:205/311.0@atarinet.ftn or on 90:304/6.0@nest.ftn, 
  58. or post a letter to:
  59.  
  60. Rich Tietjens
  61. 8495A SW Hemlock
  62. Tigard, OR  97223
  63. USA
  64.  
  65. Registration costs US$15.  You will receive your key file and the latest
  66. version of UUCP-ST via Internet email, or on floppy disks if you prefer.
  67. Additionally, you will be given a password that will allow you to log onto
  68. the STarship ftp server with direct access to the UUCP-ST release folder; 
  69. this level of access is not available to unregistered users or the general public.  
  70. Finally, you will also be given special consideration when asking for 
  71. additional features in the programs that make up UUCP-ST.
  72.  
  73. System Requirements
  74. ===================
  75.  
  76. Before installing UUCP-ST, you need to make sure that you have the 
  77. required hardware and software.
  78.  
  79.     Hardware:  UUCP-ST should run on any ST/TT/Falcon compatible with 
  80.     at least 1 megabyte of RAM and adequate hard drive space for the 
  81.     working files.
  82.     
  83.     Software:  This is a little more complex; you must have the 
  84.     following:
  85.         
  86.         (1) A working NOS setup (to allow access to your Internet 
  87.         account, both email and news)
  88.         
  89.         (2) A working Fido-compatible mail tosser and reader.
  90.         
  91.     UUCP-ST was developed using NOS-POP3, Jetmail, LED and Octopus.  
  92.     Any version of NOS that works with your provider should be fine.  
  93.     IOS can be expected to work, but has not been tested; likewise, 
  94.     any Fido-messagebase-compatible message reader or BBS should work.
  95.  
  96. Installation
  97. ============
  98.  
  99.     (1) It is assumed you have already unZipped the archive.  If you 
  100.     haven't, and you are reading this direct from ST-Zip, complete 
  101.     Step 2 and then unZip all the files into the directory created 
  102.     there.
  103.     
  104.     (2) Create a folder wherever it is convenient for your particular 
  105.     system.  The suggested folder name is "UUCP" but that is not a 
  106.     requirement.
  107.     
  108.     (3) Move all of the UUCP-ST files into the folder you just 
  109.     created.
  110.     
  111.     (4) Copy EXAMPLE.CTL to UUCP.CTL in the same folder.
  112.     
  113.     (5) Edit UUCP.CTL to conform to your particular system.  The 
  114.     provided example file is heavily commented; the comments may 
  115.     be deleted from the UUCP.CTL file, but it is strongly suggested 
  116.     that you retain the unmodified Example file for reference.
  117.     
  118.     (6) You must also edit your AREAS.BBS file to add all the 
  119.     newsgroups as Fido-style message bases.  Make sure all of the 
  120.     folders and message base files that you will be referencing with 
  121.     UUCP.CTL actually exist!  When the News Manager is completed, it 
  122.     will take care of this automatically, but in this early release, 
  123.     you are responsible for manually creating folders.
  124.     
  125.     (7) Run your mail tosser in "maintenance" mode before running 
  126.     either of the News programs for the first time.  This will ensure 
  127.     that all of the message areas exist and are the expected size.
  128.     
  129.     (8) Decide how often you wish to run the various maintenance 
  130.     programs that make up UUCP-ST; once daily is the suggested 
  131.     minimum, but all of them will run faster if they are run more 
  132.     often (as they have less to do each time, the more often they 
  133.     run).  Here is the list of programs (and commands) that we run at 
  134.     STarship each time we call the Internet: 
  135.     
  136.         Jetmail import scan pack bundle
  137.         Wormhole
  138.         EmailOut
  139.         News_Out
  140.         Unlock
  141.         NOS -d i:\oasis -s 64 startup.nos
  142.         Age_Hist
  143.         Wormhole
  144.             Email_In
  145.             News_In
  146.             Jetmail import scan pack bundle
  147.     
  148.     You'll need to create a batch file, (if you're running a CLI) or a 
  149.     function (if you're running Semper) to execute the desired 
  150.     programs in the correct order.  NOTE:  If you use Wormhole, it 
  151.     MUST be executed before Email_In, because there is no text for 
  152.     Wormhole to process after Email_In runs!
  153.  
  154. Support
  155. =======
  156.  
  157. Should you need assistance, contact me at the above-listed email 
  158. address(es) and, regardless of your registration status, I'll try to 
  159. get your setup working.  After all, you can't test the programs if you 
  160. can't make them work!
  161.